sequenceDiagram
    participant GHA as GitHub Actions
    participant Script as create-single-release.ts
    participant Git as Git Repository
    participant GitHub as GitHub API
    
    Note over GHA: CI Workflow (ci.yml)
    GHA->>GHA: Trigger on push to main/staging
    GHA->>GHA: Set COMMIT_MSG env var (secure)
    GHA->>GHA: Check if COMMIT_MSG matches version pattern
    alt Is release commit on main
        GHA->>GHA: Extract version from commit message
        GHA->>GHA: Set is_release=true
    else Not a release
        GHA->>GHA: Set is_release=false
    end
    
    Note over Script: Release Script Flow
    Script->>Git: Find version commit
    Git-->>Script: Return commit hash & metadata
    Script->>Git: Find previous version commit
    Git-->>Script: Return previous commit hash
    Script->>Git: Get commits between versions
    Git-->>Script: Return commit list
    
    loop For each commit
        Script->>GitHub: Fetch commit details via API
        GitHub-->>Script: Return author, PR number
        Script->>Script: Categorize commit (conventional format priority)
        Note over Script: 1. Check conventional prefixes<br/>2. Check other standard prefixes<br/>3. Fall back to keyword matching
    end
    
    Script->>Script: Group commits by category
    Script->>Script: Generate release notes body
    Script->>GitHub: Create GitHub release
    GitHub-->>Script: Release created successfully